home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #2 / Ham Radio 2000 - Volume 2.iso / HAMV2 / PACKET / UPDAT630 / SPKVIEW.TXT < prev    next >
Text File  |  1997-07-03  |  4KB  |  109 lines
  1. SPKVIEW V1.0
  2. ------------
  3. SPKVIEW.EXE is a WinPack viewer which allows messages to be
  4. spoken by a suitable text to speech program. It is intended that
  5. it should be installed for a file type of "SPK". From V6.22
  6. onwards, WinPack has special support for viewers for this file
  7. type.
  8.  
  9. Installation
  10. ------------
  11. To use SPKVIEW you really need a Sound Blaster card which has
  12. the text to speech program TextOle as one of its bundled
  13. software utilities. However, SPKVIEW.INI makes it possible to
  14. set up SPKVIEW for use with other text to speech programs.
  15.  
  16. Put SPKVIEW.EXE and SPKVIEW.INI in your main WINPACK directory.
  17.  
  18. Edit SPKVIEW.INI and make sure that SPEECH_PROG_PATH is correct
  19. for your copy of TextOle or other text to speech program. If you
  20. aren't using TextOle, make sure that the SPEECH_START_KEYS
  21. character sequence is correct for your text to speech program.
  22. Remove the line if your program does not need to be sent any
  23. characters to start it speaking. The characters you specify are
  24. what you would key in to start the program speaking. Use '^' for
  25. Ctrl and '%' for Alt. The default is "^p" which is correct for
  26. TextOle and means Ctrl+p.
  27.  
  28. In the [DISCARD] section of SPKVIEW.INI you can specify text
  29. strings which, if found in a line in a message will cause that
  30. line to be discarded - see "Preprocessing Rules" below. The
  31. "qqqqqqqq" and "wwwwwwww" are just examples and can be removed
  32. if you wish - they are very unlikely to occur in a message!
  33.  
  34. Run WinPack, select "File", "Viewers Editor" and install
  35. SPKVIEW.EXE as a viewer for Ext "SPK".
  36.  
  37. In Use
  38. ------
  39. Should anyone send a message with "^.SPK" in the title, WinPack
  40. will offer SPKVIEW as a viewer for that message. However, if you
  41. have WinPack V6.22 or later, you can use SPKVIEW to speak any
  42. message simply by pressing Ctrl+S whilst you are reading the
  43. message.
  44.  
  45. SPKVIEW preprocesses the message (see below) and creates a
  46. temporary output file which is passed to the text to speech
  47. program. PLEASE NOTE - when TextOle has finished speaking, you
  48. need to manually close it down, it won't automatically close. If
  49. you leave it running, then, when you try and use SPKVIEW on
  50. another message, you simply activate the old copy of TextOle and
  51. it speaks the wrong message!
  52.  
  53. Preprocessing Rules
  54. -------------------
  55. There is an obvious problem when using a text to speech program
  56. to speak packet messages - headers and fancy signature blocks
  57. don't come out too well! SPKVIEW attempts to get round this
  58. problem by applying the following preprocessing rules:-
  59.  
  60. If the message contains HTML style tags <SPEECH> and </SPEECH>,
  61. then only text between these tags is included in the output to
  62. the text to speech program. The tags must be on a line
  63. containing nothing other than the tag and there can be several
  64. pairs of tags in one message. Example:-
  65.  
  66. This text won't be spoken,
  67. and this won't be spoken.
  68. <SPEECH>
  69. This text will be spoken,
  70. and this will be spoken.
  71. </SPEECH>
  72. This text won't be spoken,
  73. and this won't be spoken.
  74. <SPEECH>
  75. This text will be spoken,
  76. and this will be spoken.
  77. </SPEECH>
  78. This text won't be spoken,
  79. and this won't be spoken.
  80. etc...
  81.  
  82. If a message doesn't contain these tags, then an attempt is
  83. made to remove the headers:-
  84.  
  85. All lines before and including the last line starting with "R:"
  86. are discarded.
  87. All lines before and including the last line starting with "T:"
  88. are discarded.
  89. All lines before and including the last line starting with
  90. "Path !" and ending with "!" are discarded.
  91. All lines before and including the last line both starting and
  92. ending with "!" are discarded.
  93.  
  94. To try and avoid the worst effects of sig blocks, any line in a
  95. message which contains a sequence of three similar characters
  96. which aren't normal text characters is discarded. Any line
  97. containing characters, none of which are numbers or letters, is
  98. also discarded.
  99.  
  100. Any lines containing any of the text strings specified in the
  101. [DISCARD] section of SPKVIEW.INI are discarded.
  102.  
  103.  
  104. Roger Barker, G4IDE
  105. roger@peaksys.demon.co.uk
  106.  
  107. July 1997
  108.  
  109.